home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / dev / misc / Bump.lha / Bump / Bump.readme < prev    next >
Encoding:
Text File  |  1999-08-11  |  3.0 KB  |  73 lines

  1. Short:    Automatic version generator, fully configurable. (+source)
  2. Author:   Robin Cloutman <rycochet@free4all.co.uk>
  3. Type:     dev/misc
  4. Version:  3.4
  5. Requires: AmigaOS 2.0+
  6.  
  7. This can easily replace C='s bumprev.
  8.  
  9. Features:
  10. · User defined output formats. (Unlike bumprev)
  11. · Remembers both version and revision. (Unlike bumprev)
  12. · Easy to use. (Unlike bumprev)
  13. · Output almost identical to bumprev. (Unlike... erm...)
  14. · Includes output for C, C++, ARexx, Asm.
  15. · Includes full source. (gcc version egcs-2.90.27 980315 (egcs-1.0.2 release))
  16. · Has installer.
  17. · 68000-68060 versions.
  18.  
  19. NOTE:
  20.   Although I have included the source code, I reserve full rights to it.
  21.   If you wish to add/change anything, then do it through me - I don't want
  22.   lots of versions hanging around...
  23.  
  24. Template:
  25.  Bump NAME/A,CODE/M,VERSION/S,SETVERSION/K/N,NO=NOREVISION/S,SETREVISION/K/N,QUIET/S
  26.  
  27.  NAME/A - the base name to use, will create "{NAME}_rev.ver" containing "{ver}.{rev}".
  28.  CODE/M - which code module(s) to use.
  29.  VERSION/S - bump the version (and set revision to 0).
  30.  SETVERSION/K/N - set the version to this.
  31.  NO=NOREVISION/S - don't bump the revision. (Useful for code generation only)
  32.  SETREVISION/K/N - set the revision to this.
  33.  QUIET/S - don't output any information for the user.
  34.  
  35. Code Generation:
  36.   All code generation files must reside in "S:" or the location pointed to by the "BUMPCODE" enviroment variable.
  37.   Each file has the name "bump-*", with the * replaced by the text in each CODE/M option.
  38.   Every line in the file starting with "##" can be -
  39.   · "## inform ..." Tell the user something.
  40.   · "## suffix ..." Close the current output file, and open another with the name "{NAME}_rev.{suffix}".
  41.   · "## filename ..." Close the current output file, and open another with this name.
  42.   · "## ..." anything else is a comment.
  43.   Replaced Symbols:
  44.   · "%n" is the name.
  45.   · "%v" is the version.
  46.   · "%r" is the revision.
  47.   · "%d" is the current date.
  48.   · "%t" is the current time.
  49.   · "%V" is the version of bump used (ie. bump 3.1).
  50.   · "%l?" is the length of the second symbol (ie. "%ld" is replaced by "8")
  51.   (see Bump-test)
  52.   NOTE: You can create more than one output file by using ##suffix and ##filename more than once!
  53.  
  54. History:
  55. · 1.0 - First effort.
  56. · 1.1 - Added rexx code.
  57. · 1.2 - Added locale support. (REMOVED)
  58. · 1.3 - Minor bug fixed...
  59. · 1.4 - Recompiled with "gcc version egcs-2.90.27 980315 (egcs-1.0.2 release)"
  60. · 1.5 - Automatically generate required code, only need switch first time. (REMOVED)
  61. · 2.0 - Made resident, otherwise no change.
  62. · 2.1 - Rewrote to make it easier to expand...
  63. · 3.0 - Changed template.
  64.         Made code output user-defined.
  65.         Removed locale support.
  66.         Removed automatic code generation.
  67. · 3.1 - Improved code parsing, user info and multiple files allowed.
  68. · 3.2 - Now searches "PROGDIR:", "S:", and $BUMPCODE for code.
  69. · 3.3 - Also searches {NAME} dir.
  70. · 3.4 - Code cleanup and new ## command (filename).
  71. · 3.5 - Recompiled with "gcc version egcs-2.91.66 19990314 (egcs-1.1.2 release)"
  72.         First Aminet release.
  73.